컨텍스트 경로

웹 애플리케이션 서버에서 컨텍스트 경로를 설정하는 방법은 서버의 종류와 버전에 따라 다르다. 일반적으로 톰캣이나 제이보스, 웹로직과 같은 자바 EE 호환 애플리케이션 서버에서는 애플리케이션 아카이브 파일의 이름이나 특정 설정 파일을 통해 컨텍스트 경로를 결정한다. 예를 들어, myapp.war라는 파일을 톰캣의 webapps 디렉터리에 배포하면 기본 컨텍스트 경로는 /myapp이 된다.

보다 명시적인 설정을 위해 서버별 구성 파일을 사용할 수 있다. 톰캣의 경우 server.xml 파일 내 <Host> 요소 안에 <Context> 요소를 추가하거나, 별도의 XML 설정 파일(예: myapp.xml)을 conf/Catalina/[호스트명]/ 디렉터리에 생성하여 경로를 정의한다. 톰캣 8.5 이상 버전에서는 자동 배포를 방지하고 server.xml에 정적 컨텍스트를 정의하는 방식을 권장하기도 한다.

다른 웹 서버 환경에서는 다른 방식을 따른다. 예를 들어, 스프링 부트로 제작된 실행 가능한 JAR 애플리케이션의 경우, 내장 톰캣이나 제티 서버의 컨텍스트 경로는 application.properties 또는 application.yml 파일에서 server.servlet.context-path 속성으로 설정한다. 이는 웹 애플리케이션 서버의 외부 설정과는 별개로 프레임워크 수준에서 관리되는 방식이다.

웹 애플리케이션의 컨텍스트 경로는 배포 설명자 파일인 web.xml을 통해 설정할 수 있다. 이 파일은 웹 애플리케이션의 WAR 파일 내 WEB-INF 디렉토리에 위치하며, 애플리케이션의 구성 정보를 담고 있다.

web.xml 파일에서 컨텍스트 경로를 명시적으로 지정하려면 <context-param> 요소를 사용할 수 있다. 그러나 일반적으로 컨텍스트 경로는 web.xml이 아닌 웹 애플리케이션 서버의 설정이나 배포 시점에 결정되는 경우가 많다. web.xml에서는 주로 서블릿 매핑, 필터, 리스너 등 애플리케이션의 내부 동작을 정의하는 데 사용된다.

실제로 톰캣과 같은 서버에서는 애플리케이션 WAR 파일의 이름이나 특정 설정 파일(server.xml 또는 context.xml)을 통해 컨텍스트 경로를 관리한다. 따라서 web.xml을 통한 설정은 서버나 프레임워크에 따라 지원 범위가 다르며, 주로 스프링 부트와 같은 현대적인 프레임워크는 내장 서버를 사용하거나 별도의 설정 파일(application.properties 또는 application.yml)을 통해 경로를 제어하는 방식을 선호한다.

컨텍스트 경로 설정은 사용하는 웹 애플리케이션 프레임워크에 따라 방법이 다르다. 대부분의 현대 프레임워크는 내장된 개발 서버를 사용하며, 이때 컨텍스트 경로는 주로 애플리케이션의 구성 파일이나 코드 내에서 지정한다.

스프링 부트 애플리케이션에서는 application.properties 또는 application.yml 파일을 통해 간단히 설정할 수 있다. server.servlet.context-path 속성에 원하는 경로를 지정하면 된다. 예를 들어, /api로 설정하면 애플리케이션의 모든 엔드포인트는 /api 접두사 하에 매핑된다. Node.js의 Express 프레임워크에서는 app.use() 메서드를 사용하여 특정 경로에 라우터 객체를 마운트하는 방식으로 컨텍스트 경로를 적용한다.

파이썬의 Django나 Flask와 같은 프레임워크에서는 프로젝트의 주 URLconf 설정이나 애플리케이션 객체 생성 시 관련 옵션을 통해 관리된다. 이러한 프레임워크별 설정 방식은 전통적인 WAR 파일 배포와 web.xml을 사용하는 방식보다 더 유연하고 선언적이다. 개발자는 빌드 도구나 배포 스크립트에 의존하지 않고도 애플리케이션 코드 내에서 배포 환경을 정의할 수 있다.

도메인 이름(Domain Name)은 인터넷 상에서 컴퓨터나 네트워크를 식별하는 주소 체계를 말한다. 숫자로 이루어진 IP 주소를 사람이 기억하고 사용하기 쉽도록 문자 형태로 변환한 것이다. 예를 들어, www.example.com과 같은 형태를 가진다. 웹 애플리케이션에 접근할 때 사용자는 먼저 이 도메인 이름을 통해 특정 서버를 찾아가게 된다.

컨텍스트 경로는 특정 도메인 이름 아래에서 하나의 웹 애플리케이션을 구분하는 경로이다. 동일한 도메인 이름과 포트를 사용하는 서버 내부에 여러 애플리케이션이 배포될 수 있는데, 이때 각 애플리케이션을 식별하는 고유한 경로가 컨텍스트 경로이다. 사용자는 도메인 이름:포트/컨텍스트경로의 형태로 URL을 구성하여 원하는 애플리케이션에 접근한다.

따라서 도메인 이름은 인터넷 상의 최상위 주소 지점을 나타내는 반면, 컨텍스트 경로는 그 주소 아래에 존재하는 구체적인 애플리케이션의 위치를 지정한다. 이는 하나의 큰 건물(도메인 이름) 안에 여러 개의 상점이나 사무실(컨텍스트 경로)이 있는 것에 비유할 수 있다.

배포 경로는 웹 애플리케이션이 웹 서버나 애플리케이션 서버 상에서 실제로 배포되고 접근되는 물리적 또는 논리적 경로를 의미한다. 이는 파일 시스템 상의 특정 디렉토리 경로이거나, 서블릿 컨테이너가 애플리케이션을 식별하기 위해 사용하는 내부 식별자로 사용될 수 있다. 배포 경로는 개발 환경에서의 프로젝트 구조와 실제 운영 서버에서의 실행 구조를 연결하는 중요한 매개체 역할을 한다.

컨텍스트 경로와의 관계에서, 배포 경로는 애플리케이션의 물리적인 배치 위치를 가리키는 반면, 컨텍스트 경로는 그 애플리케이션에 접근하기 위한 URL 상의 논리적 경로를 정의한다. 예를 들어, myapp.war 파일이 서버의 /webapps 디렉토리에 배포되었다면, 이 /webapps가 배포 경로에 해당할 수 있다. 사용자는 서버가 매핑한 컨텍스트 경로(예: /shop)를 통해 해당 배포 경로에 위치한 애플리케이션에 접근하게 된다.

주요 웹 애플리케이션 서버 제품들(Apache Tomcat, JBoss, WebSphere 등)은 각기 다른 방식으로 배포 경로를 관리한다. Tomcat의 경우 기본적으로 webapps 디렉토리가 배포 경로로 사용되며, 이 디렉토리 내에 .war 파일을 복사하거나 디렉토리를 생성함으로써 애플리케이션이 배포된다. 반면, Spring Boot로 제작된 실행 가능한 JAR 파일을 사용할 경우, 내장 서버를 통해 실행되므로 전통적인 의미의 외부 배포 경로가 필요하지 않을 수 있다.

배포 경로의 설정과 관리는 CI/CD 파이프라인과 같은 자동화된 배포 프로세스에서 핵심 요소가 된다. 올바른 배포 경로를 설정하지 않으면 애플리케이션이 서버에 로드되지 않거나, 리소스 파일을 찾지 못해 오류가 발생할 수 있다. 따라서 개발 및 운영 단계에서 배포 경로와 컨텍스트 경로의 명확한 정의와 일관된 관리가 소프트웨어 개발 생명주기 전반에 걸쳐 중요하다.